Command: QH (Query Host). Can be used in online, offline or secure state.
Function: To display details of the Host port configuration of the HSM.
Inputs: None
Outputs:
The
message header length. This is the number of characters at the front of
each command from the Host to the HSM (after the STX character). The HSM
returns the message header in the response.
The protocol used.
The character format (EBCDIC or ASCII).
In an asynchronous system, the response delay. This is the delay before
the HSM responds to the Host. It allows use of half-duplex Host communications
that require a defined delay between the transmission of a command and
the response from the HSM.
In an SNA - SDLC synchronous system, whether the interface is DCE or DTE.
In an SNA - SDLC synchronous system, the IBM environment. This can be IMS
or CICS. Message identifier and offset are shown.
In an SNA - SDLC synchronous system, the interface port type. This can
be RS-232 or V.35.
In an SNA - SDLC synchronous system, the SDLC station address.
In an asynchronous system, the Host baud rate.
In an asynchronous system, the Host word format.
In Ethernet use, the IP address. This is the Internet Protocol address
of the HSM in the system.
In Ethernet use, the Well-Known-Address. This is the publicised TCP Port
address of the HSM.
Errors: None.
Example 1 (for transparent asynchronous communications):
Online> QH <Return>
Message header length: 04
Protocol: Transparent Asynchronous
Character format: ASCII
Terminating Sequence: 03 00
Interface: DCE
Response delay (ms): 00
Baud: 9600
Word format: 7 bits, no parity, 1 stop
Example 2 (for SNA-SDLC communications):
Online> QH <Return>
Message header length: 08
Protocol: SNA/SDLC 3274
Character format: EBCDIC
Station Address: C1
Host environment: IMS
IMS message identifier: PIN,MAC
IMS identifier offset: 03
Interface: V.35, DCE
Baud: 64000
Word format: 8 bits, no parity
Example 3 (for Ethernet communication with UDP):
Online> QH <Return>
Message header length: 04
Protocol: Ethernet
Character format: ASCII
IP address: 128.100.003.001
Well-Known-Port address: 01500
Transport: UDP
Default gateway address: 128.100.003.005
Subnet mask: 255.255.255.000
Example 4 (for Ethernet communication with TCP/IP):
Online> QH <Return>
Message header length: 04
Protocol: Ethernet
Character format: ASCII
IP address: 128.100.003.001
Well-Known-Port address: 01500
Transport: TCP, 6 connections
TCP keep_alive value: 120
Default gateway address: 128.100.003.005
Subnet mask: 255.255.255.000
Example 5 (for Ethernet communication with UDP and TCP/IP):
Offline> QH <Return>
Message header length: 04
Protocol: Ethernet
Character format: ASCII
IP address: 128.100.003.001
Well-Known-Port address: 01500
Transport: UDP and TCP, 6 connections
TCP keep_alive value: 120
Default gateway address: 128.100.003.005
Subnet mask: 255.255.255.000
Example 6: (ESCON)
Offline> QH <Return>
Message header length: 04
Protocol: ESCON
Character format: EBDIC